home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / 2000last.zip / 2000LAST.DOC < prev    next >
Text File  |  1993-01-03  |  9KB  |  204 lines
  1.  
  2.                                   2000 LAST
  3.                      =================================
  4.                       version 1.00, released 01/03/93
  5.  
  6.         A public domain SysOp utility from the Charlatan's Cabin BBS
  7.                  for SysOps of Wildcat! version 3.xx ONLY.
  8.  
  9. WHAT IT DOES:
  10. -------------
  11. 2000LAST generates and automatically "trims" a listing of your most recent
  12. callers.  If enabled, it will include Wildcat! automatic color codes in
  13. any of its display files.
  14.  
  15. HOW IT WORKS:
  16. -------------
  17. Each time a caller logs off from one of your nodes, the file NODEINFO.DAT
  18. is updated to contain the caller's name, city, and time/date of logoff.
  19. 2000LAST is run immediately after each logoff ... we'll explain how to do
  20. that in a moment.
  21.  
  22. The 2000LAST.CFG (configuration file) tells 2000LAST where to find certain
  23. files and what output files to write.  Only ONE copy is required, anywhere
  24. in your DOS path.
  25.  
  26. The program determines the node number by first checking to see if the
  27. environment variable "WCNODEID=" is set.  If so, it uses that value.  If
  28. not, it next looks for DOOR.SYS in the current directory.  Remember that
  29. Wildcat! will place you in the appropriate NODE WORK directory when you
  30. shell out, and DOOR.SYS will be written there, too.
  31.  
  32. The program gathers the data, places it at the FRONT of the caller log,
  33. so that the most recent calls are first, and writes the output file(s).
  34. If the file has accumulated the configured maximum number of callers, 
  35. then the entry at the end of the file (the oldest call) will be deleted, 
  36. so you never have to trim the output file by hand.
  37.  
  38. Any caller may view this log at any time if you set it up as a bulletin.
  39.  
  40. Remember that when you first start using 2000LAST there will be only a few
  41. calls until the list builds up ... so you might wish to start it a day or
  42. two before you announce the fact that the files are available for viewing.
  43.  
  44. INSTALLATION:
  45. -------------
  46. Installing the program is easy.  
  47.  
  48. 1.   Place 2000LAST.EXE anywhere in your path so it can be run 
  49.         from any directory.  The program requires BRUN40.EXE
  50.         which you almost certainly already have.  If not, it's
  51.         widely available, including my BBS ... see below.
  52.  
  53. 2.   In your STARTUP directory, create a file called POSTCALL.BAT. Wildcat!
  54.      will automatically detect it (or POSTCALL.RUN in the work directory ...
  55.      see your Wildcat! documentation)
  56.  
  57.      Here's a sample of what it should say:
  58.  
  59.      echo off
  60.      2000LAST
  61.      exit
  62.  
  63.      The "EXIT" line isn't actually required, but it's a safe way to ensure 
  64.      that the shell will properly release control to Wildcat! if something 
  65.      goes wrong.  
  66.  
  67.      IMPORTANT:  If you have MAKEWILD set to TERMINATE instead of SHELL, 
  68.      you must create individual files named POSTCALL.RUN in each of your
  69.      node work directories.  The last line of each one must be changed from
  70.      'exit' as shown above to the name of the batch file to start the
  71.      particular Wildcat! node.  Refer to the Wildcat! documentation for more
  72.      details on SHELL and TERMINATE options ... 
  73.  
  74. 3.   Run MAKEWILD and make sure whether you're set to SHELL or TERMINATE, then
  75.      review step 2 above.
  76.  
  77. 4.   Anywhere in your DOS path, you'll create  2000LAST.CFG.  Here's an
  78.      example of 2000LAST.CFG ... 
  79.  
  80. BBSNAME=The Charlatan's Cabin BBS
  81. NODEINFO=C:\WC30\DATA\NODEINFO.DAT
  82. SAVEFILE=C:\WC30\2000LAST.DAT
  83. EXCLUDE=NONE
  84. BYPASS=NEWUSER
  85. TRANSLATE=19200,16800
  86. WRITE=C:\WC30\WCPRO.BBS /SHOWNODE /CLS /COLOR /COUNT=50
  87. WRITE=C:\WC30\BULL\BULL22.BBS /SHOWNODE /CLS /COLOR /COUNT=2000
  88.  
  89.      Line 1 BBSNAME=     is the name of your BBS for the listing header,
  90.                          e.g., BBSNAME=The Charlatan's Cabin BBS
  91.  
  92.      Line 2 NODEINFO=    is the Drive and PathName to the node information 
  93.                          file, e.g., NODEINFO=C:\WC30\DATA\NODEINFO.DAT
  94.  
  95.      Line 3 SAVEFILE=    is the Drive and PathName of the file 2000 LAST will 
  96.                          use to keep a reference copy of the callers list.
  97.                          It will be maintained automatically by 2000 LAST.
  98.                          e.g., SAVEFILE=C:\WC30\2000LAST.DAT
  99.  
  100.      Line 4 EXCLUDE=     tells the program any names (such as the sysop) to
  101.                          exclude from the listings.  If you don't want to
  102.                          exclude anyone, remove this line or leave it blank.
  103.  
  104.      Line 5 BYPASS=      tells the program any SECURITY LEVELS you want to
  105.                          exclude from the listings.  If you don't want to
  106.                          exclude levels, remove this line or leave it blank.
  107.  
  108.      Line 6 TRANSLATE=   tells the program to replace a reported baud rate
  109.                          with another value.  For example, if you have your
  110.                          MAKEWILD set to show 16800 baud connects as 19200,
  111.                          you can change them back to 16800 by using the
  112.                          command: TRANSLATE=19200,16800.
  113.                          You may have up to 10 of these TRANSLATE= lines in
  114.                          this configuration file.
  115.  
  116.        Remaining lines:  name the output files (maximum of 50 files.) 
  117.                          They will ALL be written if there is new "last 
  118.                          caller."  The format is important -- see below:
  119.  
  120.        Each line MUST begin with the phrase "WRITE=" followed by a
  121.        valid COMPLETE DOS drive/path/filename.  Any number of these 
  122.        filenames (up to 50) are executed by the program.  After the
  123.        filename, leave a space and then any combination of the available
  124.        switches:  
  125.  
  126.           /SHOWNODE  will include the Node number in the listing in the 
  127.                      display file.
  128.  
  129.           /CLS       will place a Wildcat! clear-screen code at the front of 
  130.                      the display file.
  131.  
  132.           /COLOR     will cause Wildcat! automatic color codes to be generated.
  133.                      If the caller is not ANSI-compatible, these color codes
  134.                      will NOT be displayed.  In that way, one ".BBS" file will
  135.                      suffice for BOTH your COLOR and your MONO callers.
  136.  
  137.           /COUNT=2000 specifies the number of entries to include in the file.
  138.                      Any number from 1 to 2000 is valid here.
  139.  
  140.  
  141. OPTIONAL APPROACH:
  142. ------------------
  143.      If you'll be using WCPRO to generate a BULLETIN instead of the 
  144.      [S]tatistics display for the main menu, or if you don't plan 
  145.      to run WCPRO's statistics function at all, you might do this:
  146.  
  147.      Run MAKEWILD and edit the MAIN MENU so that the default "S" command 
  148.      (system statistics) becomes something like [L]...Log of recent callers.
  149.      Be sure to change the "hot key" letter on the menu definition page to
  150.      whatever letter you select.
  151.      
  152.      Change the 2000LAST.CFG file to create WCPRO.BBS in the startup 
  153.      directory:
  154.  
  155.                      WRITE=c:\wc30\WCPRO.BBS 
  156.  
  157.        ... and add whatever other bulletins you wish to write ...
  158.  
  159.      (make whatever changes are required for your pathnames, and
  160.       as before, be sure to use the correct node number in each
  161.       config file.
  162.  
  163. You may include up to 50  WRITE= commands in the configuration file.
  164.  
  165.  
  166. Problems, questions, suggestions:
  167. ---------------------------------
  168. If you get a message from 2000LAST saying something like
  169.  
  170.                    FILES IN USE - Retry ## of 50
  171.  
  172. this means that 2000LAST thinks that another copy of 2000LAST is running
  173. on another node.  If that's NOT TRUE, then it accidentally left over a
  174. file called "2000LAST.PUK" in your C:\ directory.  You can FORCE the
  175. program to execute by typing an 'F' at this time.  It should start within
  176. 5 seconds after you press the 'F' key.
  177.  
  178. PROBLEMS, SUGGESTIONS:
  179. ======================
  180. 2000LAST is public domain.  I don't seek or accept any donations for this or
  181. any of my other Wildcat! utility programs, including TODAYBBS, FLOP, MSTAT,
  182. USTAT, and others.
  183.  
  184. I welcome suggestions, and will try to help (no guarantees) if there are
  185. problems.
  186.  
  187. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  188. your Wildcat! registration number in the comment and you'll be upgraded to
  189. membership without the usually required registration by mail.
  190.  
  191. You may also leave a message via CompuServe (70250,220).
  192.  
  193. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with
  194. the price of public domain software these days ... I just can't afford
  195. to be "on call."  I WILL respond to your questions via my BBS or CompuServe,
  196. or via the Mustang Software registered SysOp BBS.
  197.  
  198. VERSION HISTORY:
  199. =================
  200. 1.00    Compiled  01/03/93   First release version for Wildcat! 3.x
  201.                              Program is based on 300LAST, with expanded
  202.                              reporting capabilities.
  203.  
  204.